home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3c / tell.z / tell
Encoding:
Text File  |  2002-10-03  |  3.5 KB  |  67 lines
  1.  
  2.  
  3.  
  4. TTTTEEEELLLLLLLL((((3333CCCC))))                                                              TTTTEEEELLLLLLLL((((3333CCCC))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _tttt_eeee_llll_llll, _tttt_eeee_llll_llll_6666_4444 - return the read/write file pointer
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<uuuunnnniiiissssttttdddd....hhhh>>>>
  13.  
  14.      ooooffffffff____tttt tttteeeellllllll ((((iiiinnnntttt ffffiiiilllleeeeddddeeeessss))));;;;
  15.  
  16.      ooooffffffff66664444____tttt tttteeeellllllll66664444 ((((iiiinnnntttt ffffiiiilllleeeeddddeeeessss))));;;;
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      _f_i_l_e_d_e_s is a file descriptor returned from a _cccc_rrrr_eeee_aaaa_tttt, _oooo_pppp_eeee_nnnn, _dddd_uuuu_pppp, _ffff_cccc_nnnn_tttt_llll,
  20.      _pppp_iiii_pppp_eeee, or _iiii_oooo_cccc_tttt_llll, system call.  _tttt_eeee_llll_llll and _tttt_eeee_llll_llll_6666_4444 return the file pointer
  21.      associated with _f_i_l_e_d_e_s.
  22.  
  23.      The two differ in that _tttt_eeee_llll_llll returns an off_t and _tttt_eeee_llll_llll_6666_4444 returns an
  24.      off64_t.  The 64-bit offset returned by _tttt_eeee_llll_llll_6666_4444 is useful for 32 bit
  25.      applications working with 64 bit files.  This is because the 32 bit
  26.      offset returned by _tttt_eeee_llll_llll might not be large enough to represent the
  27.      current file offset.
  28.  
  29.      _tttt_eeee_llll_llll_((((_ffff_iiii_llll_eeee_dddd_eeee_ssss_)))) is equivalent to:
  30.  
  31.           _llll_ssss_eeee_eeee_kkkk_((((_ffff_iiii_llll_eeee_dddd_eeee_ssss_,,,, _0000_,,,, _SSSS_EEEE_EEEE_KKKK______CCCC_UUUU_RRRR_)))).
  32.  
  33.      _tttt_eeee_llll_llll_6666_4444_((((_ffff_iiii_llll_eeee_dddd_eeee_ssss_)))) is equivalent to:
  34.  
  35.           _llll_ssss_eeee_eeee_kkkk_6666_4444_((((_ffff_iiii_llll_eeee_dddd_eeee_ssss_,,,, _0000_,,,, _SSSS_EEEE_EEEE_KKKK______CCCC_UUUU_RRRR_)))).
  36.  
  37. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  38.      lseek(2), lseek64(2)
  39.  
  40. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  41.      On success, _tttt_eeee_llll_llll and _tttt_eeee_llll_llll_6666_4444 return the current pointer location, as
  42.      measured in bytes from the beginning of the file.
  43.  
  44.      _tttt_eeee_llll_llll and _tttt_eeee_llll_llll_6666_4444 fail if one or more of the following are true:
  45.  
  46.      _EEEE_BBBB_AAAA_DDDD_FFFF          _f_i_l_d_e_s is not an open file descriptor.
  47.  
  48.      _EEEE_SSSS_PPPP_IIII_PPPP_EEEE         _f_i_l_d_e_s is associated with a pipe or fifo.
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.